FRAME | NN n/a IE 4 DOM 1 | ||
The FRAME object reflects the FRAME element, which can only be generated inside a FRAMESET element. While Navigator knows about frames as objects, it treats a frame precisely like a window object. Internet Explorer 3 and later also observe this behavior. Therefore, for cross-platform access to frame properties and methods, see the window object listing in this chapter. But if you need access to the properties listed in this section, you must access the FRAME object via its frame ID (not name). Be aware that references to frame objects shown in this section may not work properly in the Windows 95 version of Internet Explorer 4. Also, the windowRef placeholder may be filled with parent or top if the reference is in a script contained by a child frame. | |||
HTML Equivalent<FRAME> | |||
Object Model Reference
|
borderColor | NN n/a IE 4 DOM n/a | ||
Read/Write | |||
Color of the frame's border. Each browser and operating system may resolve conflicts between different colored borders differently, so test any changes your scripts make to the color of individual frame borders. | |||
Exampleparent.document.all.myFrame.borderColor = "salmon" | |||
Value A hexadecimal triplet or plain-language color name. A setting of empty is interpreted as "#000000" (black). |
|||
|
dataFld | NN n/a IE 4 DOM n/a | ||
Read/Write | |||
Used with IE 4 data binding to associate a remote data source column name to the frame's SRC attribute. A DATASRC attribute must also be set for the element. Setting both the dataFld and dataSrc properties to empty strings breaks the binding between element and data source. | |||
Exampleparent.document.all.myFrame.dataFld = "linkURL" | |||
Value Case-sensitive identifier of the data source column. | |||
|
dataSrc | NN n/a IE 4 DOM n/a | ||
Read/Write | |||
Used with IE 4 data binding to specify the name of the remote ODBC data source (such as an Oracle or SQL Server database) to be associated with the element. Setting both the dataFld and dataSrc properties to empty strings breaks the binding between element and data source. | |||
Exampleparent.document.all.myFrame.dataSrc = "#DBSRC3" | |||
Value Case-sensitive identifier of the data source. | |||
|
frameBorder | NN n/a IE 4 DOM n/a | ||
Read/Write | |||
Controls whether an individual frame within a frameset displays a border. Controlling individual frame borders appears to be a problem for most browsers in most operating system versions. Turning off the border of one frame may have no effect if all adjacent frames have their borders on. Feel free to experiment with the effects of turning some borders on and some borders off, but be sure to test the final effect on all browsers and operating systems used by your audience. Rely more comfortably on the FRAMEBORDER attribute or frameBorder property of the entire FRAMESET. | |||
Exampleparent.document.all.otherFrame.frameBorder = "no" | |||
Value Internet Explorer 4 accepts the string values of 1 (on) and 0 (off) as well as yes and no. | |||
|
height | NN n/a IE 4 DOM n/a | ||
Read/Write | |||
The height in pixels of the element. Changes to these values are immediately reflected in reflowed content on the page. Be aware that some elements, such as the IMG, may scale to fit the new dimension. | |||
Exampleparent.document.all.myFrame.height = 250 | |||
Value Integer. | |||
|
marginHeight, marginWidth | NN n/a IE 4 DOM n/a | ||
Read/Write | |||
The number of pixels between the inner edge of a frame and the content rendered inside the frame. The marginHeight property controls space along the top and (when scrolled) bottom edges of a frame; the marginWidth attribute controls space on the left and right edges of a frame. Without any prompting, Internet Explorer 4 automatically inserts a margin of 14 (Windows) or 8 (Macintosh) pixels inside a frame. But if you attempt to override the default behavior, be aware that setting any one of these two attributes causes the value of the other to go to zero. Therefore, unless you want the content to be absolutely flush with various frame edges, you need to assign values to both attributes. | |||
Exampleparent.document.all.myFrame.marginHeight = 14 parent.document.all.myFrame.marginWidth = 5 | |||
Value Positive integer value or zero. | |||
|
name | NN n/a IE 4 DOM 1 | ||
Read/Write | |||
The identifier associated with a frame for use as the value assigned to TARGET attributes or as script references to the frame. The value is usually assigned via the NAME attribute, but it can be modified by script if necessary. | |||
Exampleif (parent.frames[1].name == "main") { ... } | |||
Value Case-sensitive identifier that follows the rules of identifier naming: it may contain no whitespace, cannot begin with a numeral, and should avoid punctuation except for the underscore character. | |||
|
noResize | NN n/a IE 4 DOM 1 | ||
Read/Write | |||
Whether the frame can be resized by the user. All border edges of the affected FRAME element become locked, meaning all edges that extend to other frames in the frameset remain locked as well. | |||
Exampleparent.document.all.frameID.noResize = "true" | |||
Value Boolean value: true | false. | |||
|
scrolling | NN n/a IE 4 DOM 1 | ||
Read/Write | |||
The treatment of scrollbars for a frame when the content exceeds the visible area of the frame. You can force a frame to display scrollbars at all times or never. Or you can let the browser determine the need for scrolling. | |||
Exampleparent.document.all.mainFrame.scrolling = "yes" | |||
Value One of three constants (as a string): auto | no | yes. | |||
|
src | NN n/a IE 4 DOM n/a | ||
Read/Write | |||
URL of the external content file loaded into the frame. To change the content, assign a new URL to the property. For cross-platform applications, you can also set the location.href property of the frame to load a different document into the frame using window-related references (parent.frameName.location.href = "newDoc.html"). | |||
Exampleparent.document.all.myFrame.src = "images/altNavBar.jpg" | |||
Value Complete or relative URL as a string. | |||
|